home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / rbbs_pc / rbtch180.zip / FAKEXFER.ZIP / FAKEXFER.DOC next >
Text File  |  1992-08-16  |  14KB  |  345 lines
  1.  
  2.  
  3.  
  4.                           -----------------
  5.                           F A K E - X F E R
  6.                           -----------------
  7.  
  8.                    A File Posting Utility for SysOp's
  9.                     Running RBBS-PC and RBatch 1.80
  10.  
  11.  
  12.  
  13.  
  14.                       FAKEXFER.EXE - Version 1.03
  15.                           Dan Shore - SysOp
  16.                             June 13, 1992
  17.                           THE SHORELINE BBS
  18.                           301-946-2771 (HST)
  19.                       DGS Systems Group (Wonder)
  20.  
  21.  
  22.  
  23.  
  24.  
  25. A.  What is FAKEXFER?
  26.     -----------------
  27.  
  28. Have you ever called another BBS to "suck files" and then have to
  29. go through the hassel of posting them manually to your FMS/.DIR
  30. file system?  Well this program was written to try to ease that
  31. burden of a SysOp's Life.
  32.  
  33. By using this program along with RBatch 1.76, you can now get
  34. assistance with your file posting.  Once you have created your
  35. "FakeXfer" file (see Section C - Running FakeXfer), you then
  36. run RBatch (see Section D - Using RBatch with your FakeXfer)
  37. and start to categorize your uploads.  If the file has a
  38. FILE_ID.DIZ or a DESC.SDI inside of it, then that description
  39. will be used for the file currently being processed.
  40.  
  41. If the file does not have an internal description file, and if you
  42. have created a .DOZ (Description Outside of Zip - (C) 1992 Dan Shore)
  43. file, this description from the .DOZ will be used.  Also, if the .DOZ
  44. file contains a category code, then this category code is used and
  45. no intervention is needed by the SysOp when RBatch is processing files.
  46. In other words, AUTOMATIC FILE POSTING WITH MINIMAL WORK BY THE SYSOP!!!
  47.  
  48.  
  49. RBatch will always try to process a FILE_ID.DIZ or DESC.SDI file
  50. before using a .DOZ file.
  51.  
  52. ******************* AUTOMATED UPLOADS **********************
  53.  
  54. If a file has a FILE_ID.DIZ or a DESC.SDI and a .DOZ file is also
  55. present, RBatch will use the description from the FILE_ID.DIZ or
  56. DESC.SDI and then use the category code from the .DOZ file.  This
  57. means that once a SysOp/user starts an upload from RBBS with this
  58. scenario, no intervention is needed as RBatch takes care of everything!!
  59.  
  60. If there is no FILE_ID.DIZ, DESC.SDI or .DOZ file, then RBatch
  61. will prompt you for the file description, and category code.
  62.  
  63.  
  64.  
  65. B.  What is a .DOZ file?
  66.     --------------------
  67.  
  68. The .DOZ file was created for the type of files that cannot
  69. accept a FILE_ID.DIZ or a DESC.SDI.  What types of files are these
  70. do you ask?  Well, any file that cannot accept another file "inside"
  71. of a file (.GIF's are an excellent example).  Remember that the
  72. .DIZ or .SDI are just text files that are added into compressed files.
  73.  
  74. Also, .DOZ files are very useful when you are posting files locally
  75. to your BBS with RBatch & FakeXfer.  As you decompress a file to read the
  76. doc's to figure out what you have just "sucked" for your BBS, you can
  77. cut and paste a section of the documentation that describes the
  78. file and put that in the .DOZ
  79.  
  80. The best way to do it is to screen capture the file listing on the BBS
  81. that you are downloading the files from.  Then just edit that file to
  82. add in the nescessary information that the .DOZ file needs.  This edited
  83. list need only have the {FI and the category code and the text can have
  84. leading spaces as RBatch will "strip" out the extra spaces.  For example
  85. if you do a screen capture from a PC-Board system, you do not have
  86. to move all the text to the left margin, just have the first line follow
  87. the .DOZ format and the file will post correctly to your FMS/.DIR
  88. (See Section G for an example)
  89.  
  90. See the next section on the structure of the .DOZ file.
  91.  
  92.  
  93. B-1.  The .DOZ File Structure
  94.       -----------------------
  95.  
  96. The .DOZ filename can be anything as long as it is a legal DOS filename.
  97. The internal structure of a .DOZ is as follows:
  98.  
  99.                 {FI dflat8.zip window
  100.                 Description of file goes here with a maximum
  101.                 line length of 75 characters and a maximum
  102.                 of 10 lines
  103.                 {FI ved201.zip utils
  104.                 Description of file goes here with a maximum
  105.                 line length of 75 characters and a maximum
  106.                 of 10 lines
  107.  
  108.  
  109. Line 1 :  ALWAYS STARTS WITH A {FI and then the filename.  Note
  110.           that there is a space between the {FI, filename, &
  111.           the category code.  Note that there is no path for
  112.           the file.  (The {FI is the  Smart Text variable for
  113.           FileName in RBBS, hence it seemed logical to use this
  114.           as part of the structure - Also note that this code is
  115.           a {FI and not {F1).
  116.  
  117.    #####  The text MUST START AT THE LEFT MARGIN.  The example
  118.           above starts in the middle of the screen for ease of
  119.           reading.
  120.  
  121.           The category code is the code that a user would normally
  122.           type when prompted to categorize a file.  This is NOT
  123.           THE THREE DIGIT CODE in your FMS.  For example if your
  124.           DIR.CAT had this entry:
  125.  
  126.           "GAMES","GAM","All Games"
  127.  
  128.           The .DOZ entry would look like this:
  129.  
  130.           {FI WARRIORS.ZIP GAMES
  131.           This is a great graphical warrior game
  132.  
  133.  
  134. Line 2 thru 11 :  The description of the file to be posted, with
  135.                   a MAXIMUM line length of 80 chars and a maximum
  136.                   of 20 lines.
  137.  
  138.  
  139. --------------------------- IMPORTANT ------------------------------------
  140.  
  141. The .DOZ file is uploaded to a BBS as part of the Uploading process and
  142. can be sent first, in the middle, or last, it does not matter.
  143.  
  144. When using .DOZ files for local posting by the SysOp, you want your .DOZ
  145. file TO BE IN THE SAME DIRECTORY as the files that FAKEXFER is processing.
  146. After the fakexfer file is generated, the .DOZ file will be copied to the
  147. upload directory with all the other files.  If the .DOZ file is not in the
  148. upload directory, RBatch will not recognize the it, hence you will be
  149. prompted for descriptions/categories.
  150.  
  151. --------------------------------------------------------------------------
  152.  
  153.  
  154.  
  155. C.  Running FAKEXFER
  156.     ----------------
  157.  
  158. You can run FAKEXFER two ways.  First just type the program name
  159. and the opening menu will appear as shown below.  Or type the program
  160. name with the four command line parameters needed as follows:
  161.  
  162.  
  163.         FAKEXFER FAKEXFER.DEF C:\JUNK C:\DAN D:\NEW
  164.                      ^           ^       ^      ^
  165.                      1           2       3      4
  166.  
  167.         Note that these numbers correspond with the descriptions
  168.         following the example below.
  169.  
  170.  
  171.  
  172. If you just type the program name itself a color menu will appear just
  173. like the example below:
  174.  
  175.  
  176.                            F A K E - X F E R
  177.                           By Dan Shore -- SysOp
  178.                             THE SHORELINE BBS
  179.                               (301)946-2771
  180.                        DGS Systems Group - (Wonder)
  181.  
  182.  
  183.    Enter Name of the XFER-?.DEF File to create (Filename Only, No Path)
  184.    : xferup.def
  185.    Enter Path/Directory where XFER File should be created
  186.    : c:\junk
  187.    Enter the Full Path to the directory of the files to be processed
  188.    : c:\files
  189.    Enter Path/Directory where Processed Files are copied to
  190.    : d:\uploads
  191.  
  192.  
  193. Note that your repsonses are at the ":" prompt.  I will cover each item now.
  194.  
  195.  
  196. 1. This is the name of the Xfer file that you wish to create.  Do not
  197.    create a Xfer file that might conflict with your BBS, if you are
  198.    doing this while the BBS is up.  (Example:  XFER-1.DEF - Don't use)
  199.  
  200. 2. The program will create the xfer file that you specified in line 1
  201.    in this directory.  Do not use the same directory that you specify
  202.    in the 3rd or 4th response!
  203.  
  204. 3. This is the directory that contains the files that you wish to post
  205.    to your BBS.  The only files in this specified directory should be
  206.    the ones that are to be posted!!  The program will search this
  207.    directory to get the file size and the filename of EACH FILE for
  208.    preparation of the "FakeXfer" file.  Note that your .DOZ file
  209.    should also reside in this directory if you are using one.
  210.  
  211. 4. This is where the processed files will be COPIED to, once the program
  212.    has generated the "FakeXfer" file.
  213.  
  214.  
  215. Notes:  Make sure that the path given for the "Fake" Xfer file is the
  216.         same as the one in your special RBatch Configuration File.
  217.         (Line 11 of your RBatch Configuration File)
  218.  
  219.         Make sure that the path to copy the processed files to,
  220.         is the same as your Upload Path in your special RBatch
  221.         Configuration File. (This is the first line in your RBatch
  222.         Configuration File)
  223.  
  224.  
  225. D.  Using RBatch with the "Fake" Xfer File
  226.     --------------------------------------
  227.  
  228. I recommend that you copy one of your RBatch Configuration files to
  229. make a specific file for the "FakeXfer" program to work with.   Make
  230. sure that you have the correct "FakeXfer" filename listed in this new
  231. configuration file.
  232.  
  233. Now to be able to use the "Fake" Xfer with RBatch type the following
  234. command, which will allow RBatch to run in "Local" Mode.
  235.  
  236.                RBatch C:\Fake\Batchup.Cfg 0 Z 2
  237.                  ^            ^           ^ ^ ^
  238.                  1            2           3 4 5
  239.  
  240. 1.  RBatch program name
  241. 2.  Name of configuration file with path to it, if in a directory
  242.     other than the current directory.
  243. 3.  Port Number (0 = Local)
  244. 4.  Protocol Letter (Your Choice)
  245. 5.  Node Number (A "Local Node" Number is highly recommended)
  246.  
  247.  
  248. Notes:
  249.  
  250.      - If you use a Node Number other than a local one, the last person
  251.        who was on that node will be given upload file credits, so using
  252.        a local node will prevent this.  This way you the SysOp who uses
  253.        the local node will get the file credits!  This makes you look
  254.        very good in your BBS Statistics if you keep them for the SysOp!
  255.  
  256.      - Why if you don't use a local node number will someone else get
  257.        file credits?  Good Question....10 Points for you!  What happens
  258.        is that RBatch reads the Node Record for the username and then
  259.        hashes the users file for the file credits.
  260.  
  261.      - In your RBatch Configuration file, for this "Fake" Xfer posting,
  262.        the callers file that you list will be the one that RBatch
  263.        also posts information to.  If you wish, you can create your own
  264.        callers file just for this program or again use the callers
  265.        file for the Local Node.
  266.  
  267. **** - If you are running RBBS 17.3C or below, RBatch will have to make
  268.        its own DORINFO?.DEF file.  To be able to tell who the user is,
  269.        RBatch reads the NODE RECORD of the message base (1st field - this
  270.        file format is described in Appendix A of the RBBS manual).  Why
  271.        is this important?  Well, if you are posting files locally and you
  272.        only have a single node system (no local node), the username that
  273.        was last on the BBS, (name in node record) will be used in the
  274.        dorinfo?.def file.  So, this means that user will get the file
  275.        credits for the files that you are posting.
  276.  
  277.        How do you get around this?  There are three ways:
  278.  
  279.        1.  Make a local node on your BBS, and sign on at least once.
  280.            Since the SysOp is the only one with access to the local
  281.            node, the SysOp name will always be used as the name in
  282.            the dorinfo?.def file.
  283.  
  284.        2.  Log onto your Node1 as the SysOp before posting files
  285.            using RBatch to your BBS.
  286.  
  287.   #### 3.  Get a copy of a dorinfo?.def file and rename it DORINFO0.DEF
  288.            Then in your configuration file, specify "NO" to  have
  289.            RBatch make a configuration file and list DORINFO0.DEF
  290.            as the file for RBatch to use.  Make sure that you edit
  291.            the dorinfo file so that it has COM0 as the port number,
  292.            and SYSOP as the first name and a blank line as the second
  293.            name.  I RECOMMEND THIS METHOD IF YOU DO NOT USE A LOCAL
  294.            NODE ON YOUR BBS!!
  295.  
  296.  
  297.  
  298. E.  FILE_ID.DIZ, DESC.SDI, or FILENAME.DOZ ?
  299.     ----------------------------------------
  300.  
  301. If the file that your are posting has a .DIZ or .SDI, that file
  302. will be used for the description.  If it does not and a .DOZ file
  303. exists in the upload directory, then the description will be used
  304. from the .DOZ file.  If none of these files exists, RBatch will
  305. prompt you for a description.
  306.  
  307.  
  308. F.  Upload Categorization
  309.     ---------------------
  310.  
  311. If you specify a category code in the .DOZ file, RBatch will compare
  312. this code to your DIR.CAT file, and if there is a match, you will not
  313. have to categorize the file.  If the file contains a .DIZ or .SDI and
  314. you also have a .DOZ file, the file description will be used from the
  315. .DIZ/.SDI file, and the category will be used from the .DOZ file.  This
  316. makes the local file posting totaly automated once you start RBatch.
  317.  
  318.  
  319.  
  320. G.  Screen Capture from a PC-Board System and posting the files
  321.     to your BBS with Minimal Editing!
  322.     -----------------------------------------------------------
  323.  
  324. Here is what a file listing might look like before editing:
  325.  
  326. FILENAME.ZIP  234556 08-18-92  Here is a file that you all should have
  327.                                in your file library.  It is slick, fast
  328.                                and the best thing since sliced bread.
  329.                                Download today and try it out for yourself.
  330.  
  331.  
  332. Now here is the same file after editing it for a .DOZ file:
  333.  
  334. {FI FILENAME.ZIP MISC
  335. Here is a file that you all should have
  336.                                in your file library.  It is slick, fast
  337.                                and the best thing since sliced bread.
  338.                                Download today and try it out for yourself.
  339.  
  340. Note that the size and date are edited out which brings the first line
  341. to the left margin, but the rest of the text need not be touched at
  342. all!!  RBatch will read this file and "strip" out all the extra spaces
  343. and post this file to your FMS or .DIR system properly.
  344.  
  345.